home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / load.zip / LOAD.DOC next >
Text File  |  1988-10-16  |  15KB  |  397 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  Load Process Command
  8.  
  9.  
  10.           1  Introduction
  11.  
  12.                   1
  13.           Desqview  provides the user a way to run multiple jobs, called
  14.           processes, on his/her PC simultaneously.  However, as supplied,
  15.           there are two limitations that can be annoying.
  16.  
  17.              1.  The creation of a new process requires keyboard commands
  18.                  from the operator.  There is no convenient way for a
  19.                  regular DOS program or batch file to create a new process
  20.                  to perform some specific task such as printing a file in
  21.                  background without the PC operator entering a set of
  22.                  Desqview keyboard commands.
  23.  
  24.              2.  When a new process is created, the disk directory in which
  25.                  it will run is fixed by the DIRECTORY entry in the PIF
  26.                  file (fixed at the time the PIF file is defined by the Add
  27.                  Program or Change Program commands).  For example, if you
  28.                  have an editor that takes the file to edit as an argument,
  29.                  you must manually start the editor process, then supply
  30.                  the full path name for the file (or change directories in
  31.                  the editor and enter the file name).  It would be very
  32.                  convenient for cases like this to be able to start the
  33.                  editor in a specific directory and specify the much
  34.                  shorter file name directly.
  35.  
  36.           The LOAD utility is intended to cover these situations.  When
  37.           running under Desqview, in a DOS window or under a DOS program's
  38.           EXEC or DOS SERVICES command, this utility can be invoked to load
  39.           any Desqview process (as defined in the Desqview OPEN menu) with
  40.           the options of specifying local disk directory and a initial
  41.           command line tail.  The LOAD utility requires Desqview Version 2
  42.           or later for proper operation.
  43.  
  44.           This program is released into the public domain.  The author
  45.           assumes no responsibility for any benefits or damages resulting
  46.           from its use.
  47.  
  48.           The remaining sections describe how to install the LOAD utility,
  49.           how to invoke it once it is installed, how to setup your Desqview
  50.           PIFs to use LOAD's directory and command line options, and some
  51.           answers to questions (problems?) that you might encounter.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           _________________________________________________________________
  59.  
  60.           1. Desqview is a trademark of Quarterdeck Office Systems
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           2  Installation of LOAD.EXE
  74.  
  75.  
  76.           Before you can run LOAD.EXE, you must tell it where to find your
  77.           Desqview files and you must place the configured LOAD.EXE file in
  78.           a directory in your DOS search path.  The first is simple, the
  79.           latter can be more frustrating.
  80.  
  81.           To configure (and create) the LOAD.EXE file, copy the file
  82.           NEWLOAD.EXE into your Desqview directory.  Normally this is C:\DV
  83.           for hard disk users but it must be the drive and directory where
  84.           the Desqview files will be found when you wish to load a process.
  85.           Then run Desqview and OPEN the DOS 128K process (usually D1 on
  86.           your OPEN menu).  At the DOS prompt, enter the command
  87.  
  88.                                        newload
  89.  
  90.           and you should get a couple of lines saying that LOAD.EXE has
  91.           been created (it will be in the same directory as NEWLOAD.EXE).
  92.           (If you do not, check that you are in the Desqview directory and
  93.           that NEWLOAD.EXE is located there).  You can then delete
  94.           NEWLOAD.EXE - you will not need it again unless you change your
  95.           Desqview drive or directory.
  96.  
  97.           You should now copy LOAD.EXE into the appropriate directories
  98.           where it will be found by the processes from which you will wish
  99.           to invoke it.  For processes like the DOS 128K D1 process which
  100.           are loaded by the DOS COMMAND.COM program, this can be any
  101.           directory in the DOS PATH sequence.  For processes that are
  102.           loaded directly by Desqview (see your Desqview manual in the
  103.           section on defining PIFs for the difference here), you may need
  104.           to place a copy of LOAD.EXE in the local directories since the
  105.                                                            2
  106.           DOS PATH may not be fully defined in those cases.
  107.  
  108.  
  109.           3  Invocation of LOAD Utility
  110.  
  111.  
  112.           The following discussion assumes you are invoking LOAD.EXE from a
  113.           DOS prompt (or batch file) under the D1 process.  Invocation
  114.           under other processes should be similar but may differ slightly
  115.           (for example, you may have to specify a path name to get to the
  116.           LOAD.EXE file if it is not in your current directory and DOS
  117.           PATH).  The general command format is ([..] are optional)
  118.  
  119.                                  load [&]xx [params]
  120.  
  121.           where
  122.           _________________________________________________________________
  123.  
  124.           2. If you should change the location of your Desqview directory,
  125.              it will be necessary to rerun NEWLOAD.EXE and replace all
  126.              copies of LOAD.EXE with the new version.
  127.  
  128.  
  129.  
  130.                                         - 2 -
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           xx             Is the two character selector (from your Desqview
  140.                          OPEN menu) that specifies the process to be
  141.                          created.
  142.  
  143.           &              Optionally specifies that the new process is be
  144.                          placed in the background.  Normally, Desqview
  145.                          places the new process in the foreground for you
  146.                          to command.  If & is specified, however, your
  147.                          original process will remain the foreground
  148.                          process and the new process will be run in
  149.                          background.
  150.  
  151.           params         This the optional text for the program parameters.
  152.                          Assuming your PIF is configured for this option
  153.                          (described in the next section), these field(s)
  154.                          will be passed to the new process.  The maximum
  155.                          length is 63 characters including leading and
  156.                          delimiting blanks.  Basically this is the command
  157.                          line tail for the program that begins running in
  158.                          the new process.  If your new princess' PIF is not
  159.                          configured for this option, the params field(s)
  160.                          are ignored.
  161.  
  162.           Note that no directory is specified.  Assuming your PIF is setup
  163.           as described in the next section, LOAD will start your new
  164.           process in your original process' directory.  If your PIF is not
  165.           configured for this option, the new process will be started in
  166.           its PIF specified directory (like Desqview normally does).
  167.  
  168.           While several error messages are possible, the only likely ones
  169.           from LOAD are (1) process creation failed (additional information
  170.           will have been supplied by Desqview itself), and (2) xx-PIF.DVP
  171.           file not found (indicating that xx is not a valid selector or
  172.           your Desqview directory (see Installation) is incorrectly
  173.           specified).
  174.  
  175.  
  176.           4  Setting Up PIFs for LOAD
  177.  
  178.  
  179.           This section assumes you are familiar with the setting up of PIF
  180.           entries from the Desqview AP and CP selections on the OPEN menu
  181.           and the related sections of the Desqview manual.  For this
  182.           discussion, you may want to bring up the first PIF screen from
  183.           the CP command on your Desqview OPEN menu.
  184.  
  185.           For LOAD to start a process in the current directory, the
  186.           DIRECTORY field in the PIF for the process must be blank.  If the
  187.           DIRECTORY field is not blank (contains a directory
  188.           specification), LOAD starts the process in the PIF-specified
  189.           directory.  Note that this is different from the Desqview OPEN
  190.           menu start-up, where a blank DIRECTORY field causes a process to
  191.           start up in the user's Desqview directory.
  192.  
  193.  
  194.  
  195.  
  196.                                         - 3 -
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           For LOAD to use the optional parameters for the command line
  206.           tail, the PARAMETERS field in the PIF must contain the single
  207.           character "?".  If that field consists of a single question mark,
  208.           and the LOAD command line includes optional parameters, the
  209.           optional parameters are used exactly as if they had been included
  210.           in the PIF description.  Otherwise, the treatment of the
  211.           PARAMETERS field will be the same as Desqview's normal treatment.
  212.  
  213.  
  214.           5  Common Questions and Problems
  215.  
  216.  
  217.           Here are some common questions and (hopefully) solutions that
  218.           come up when using LOAD.  The list is not intended to be all
  219.           encompassing but rather to cover some items that arise
  220.           frequently.
  221.  
  222.              1.  When I try to run some Desqview supplied programs, like
  223.                  the Memory System utility, from LOAD, they sometimes fail.
  224.                  -- This usually means that the process selected expects to
  225.                  run in the Desqview directory, the DIRECTORY field in the
  226.                  PIF is blank, and you are requesting them with the LOAD
  227.                  command while running in a directory other than
  228.                  Desqview's.  Using the Change Program (CP) selection to
  229.                  set the DIRECTORY field to your Desqview directory path
  230.                  will usually remedy the problem.
  231.  
  232.              2.  When I try to run my favorite xxxxxxx program, it seems to
  233.                  ignore my command line parameters (or gives a invalid
  234.                  command line error) -- Some programs, particularly some
  235.                  DOS utilities and older descendants from earlier operating
  236.                  systems, are very fussy about the internal format of their
  237.                  command lines.  Try modifying the program's PIF to have
  238.                  the program started by DOS rather than Desqview (see the
  239.                  Desqview manual).  If that does not work, try running the
  240.                  program as a DOS .bat file (again, modifying the PIF to
  241.                  run the .bat file).
  242.  
  243.              3.  When I create a process in background (with the & option),
  244.                  how do I see how its doing? -- Like processes created from
  245.                  the OPEN menu, processes created by LOAD will appear on
  246.                  the Desqview SWITCH menu and can be accessed by the same
  247.                  means.
  248.  
  249.              4.  When I create a new process in background using the &
  250.                  option, I seem to be ignored by my original process for
  251.                  several seconds (then it catches up with a bang!)  -- When
  252.                  a background process is very disk intensive, Desqview and
  253.                  your machine can be so tied up servicing its requests that
  254.                  your foreground job does not get much time to run.  This
  255.                  is particularly true if the background job is a DOS COPY
  256.                  operation or other disk intensive operation.  If you wish,
  257.                  you can adjust the time slices within Desqview but this is
  258.                  probably best lived with.
  259.  
  260.  
  261.  
  262.                                         - 4 -
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.              5.  My PARAMETER field has a question mark but LOAD does not
  272.                  pass my parameters on to the new process -- Check that the
  273.                  PARAMETER field in your PIF only contains a question mark
  274.                  - no additional blanks or other characters are permitted
  275.                  for this option to work.
  276.  
  277.              6.  The params I specify with the LOAD command need to have
  278.                  several blanks inside them, but only one blank seems to
  279.                  actually get to my new process (or I am using quote marks
  280.                  in my params field and they disappear) -- The parser in
  281.                  LOAD.EXE uses the common C command line parsing algorithm
  282.                  which can be undesirable in some situations.  Try
  283.                  enclosing your params field in single or double quote
  284.                  marks.  See also question 2.
  285.  
  286.              7.  When I try to run LOAD, I get a message saying LOAD not
  287.                  found -- Check to see that LOAD.EXE is in your current
  288.                  process' directory or command path.
  289.  
  290.              8.  When I create a new process with LOAD, sometimes other
  291.                  processes get swapped out or I get a message saying
  292.                  process creation is blocked -- As with process creations
  293.                  from the OPEN menu, this means that you have run out of
  294.                  usable memory for running new processes.  Delete some of
  295.                  your current processes and try again.
  296.  
  297.  
  298.           6  Final Comments
  299.  
  300.  
  301.           Three files are included in this archive:  LOAD.DOC (this file),
  302.           NEWLOAD.EXE (a self initializing image of LOAD.EXE), and
  303.           NEWLOAD.C (the C source file for NEWLOAD.EXE/LOAD.EXE).  While I
  304.           cannot promise support for any of these, I would be interested in
  305.           hear about your experiences, successes and problems as well as
  306.           any interesting other utilities or tricks you have found for
  307.           running with Desqview.
  308.  
  309.                                         Don Dempsey
  310.                                         70701,1726
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                         - 5 -
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.                                     Contents
  344.  
  345.  
  346.                   1  Introduction  . . . . . . . . . . . . . . . . . 1
  347.                   2  Installation of LOAD.EXE  . . . . . . . . . . . 2
  348.                   3  Invocation of LOAD Utility  . . . . . . . . . . 2
  349.                   4  Setting Up PIFs for LOAD  . . . . . . . . . . . 3
  350.                   5  Common Questions and Problems . . . . . . . . . 4
  351.                   6  Final Comments  . . . . . . . . . . . . . . . . 5
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                           i
  395.  
  396.  
  397.